home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / g_man / cat3 / OpenGL / glcalllists.z / glcalllists
Encoding:
Text File  |  2002-10-03  |  11.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ggggllllCCCCaaaallllllllLLLLiiiissssttttssss((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllCCCCaaaallllllllLLLLiiiissssttttssss((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      ggggllllCCCCaaaallllllllLLLLiiiissssttttssss - execute a list of display lists
  10.  
  11.  
  12. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  13.      void ggggllllCCCCaaaallllllllLLLLiiiissssttttssss( GLsizei _n,
  14.                        GLenum _t_y_p_e,
  15.                        const GLvoid *_l_i_s_t_s )
  16.  
  17.  
  18. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  19.      _n      Specifies the number of display lists to be executed.
  20.  
  21.      _t_y_p_e   Specifies the type of values in _l_i_s_t_s.  Symbolic constants
  22.             GGGGLLLL____BBBBYYYYTTTTEEEE, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____IIIINNNNTTTT,
  23.             GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT, GGGGLLLL____FFFFLLLLOOOOAAAATTTT, GGGGLLLL____2222____BBBBYYYYTTTTEEEESSSS, GGGGLLLL____3333____BBBBYYYYTTTTEEEESSSS, and GGGGLLLL____4444____BBBBYYYYTTTTEEEESSSS
  24.             are accepted.
  25.  
  26.      _l_i_s_t_s  Specifies the address of an array of name offsets in the display
  27.             list.  The pointer type is void because the offsets can be bytes,
  28.             shorts, ints, or floats, depending on the value of _t_y_p_e.
  29.  
  30. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  31.      ggggllllCCCCaaaallllllllLLLLiiiissssttttssss causes each display list in the list of names passed as _l_i_s_t_s
  32.      to be executed.  As a result, the commands saved in each display list are
  33.      executed in order, just as if they were called without using a display
  34.      list.  Names of display lists that have not been defined are ignored.
  35.  
  36.      ggggllllCCCCaaaallllllllLLLLiiiissssttttssss provides an efficient means for executing more than one
  37.      display list.  _t_y_p_e allows lists with various name formats to be
  38.      accepted.  The formats are as follows:
  39.  
  40.      GGGGLLLL____BBBBYYYYTTTTEEEE                  _l_i_s_t_s is treated as an array of signed bytes,
  41.                               each in the range -128 through 127.
  42.  
  43.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE         _l_i_s_t_s is treated as an array of unsigned bytes,
  44.                               each in the range 0 through 255.
  45.  
  46.      GGGGLLLL____SSSSHHHHOOOORRRRTTTT                 _l_i_s_t_s is treated as an array of signed two-byte
  47.                               integers, each in the range -32768 through
  48.                               32767.
  49.  
  50.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT        _l_i_s_t_s is treated as an array of unsigned two-
  51.                               byte integers, each in the range 0 through
  52.                               65535.
  53.  
  54.      GGGGLLLL____IIIINNNNTTTT                   _l_i_s_t_s is treated as an array of signed four-byte
  55.                               integers.
  56.  
  57.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT          _l_i_s_t_s is treated as an array of unsigned four-
  58.                               byte integers.
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ggggllllCCCCaaaallllllllLLLLiiiissssttttssss((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllCCCCaaaallllllllLLLLiiiissssttttssss((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      GGGGLLLL____FFFFLLLLOOOOAAAATTTT                 _l_i_s_t_s is treated as an array of four-byte
  75.                               floating-point values.
  76.  
  77.      GGGGLLLL____2222____BBBBYYYYTTTTEEEESSSS               _l_i_s_t_s is treated as an array of unsigned bytes.
  78.                               Each pair of bytes specifies a single display-
  79.                               list name.  The value of the pair is computed as
  80.                               256 times the unsigned value of the first byte
  81.                               plus the unsigned value of the second byte.
  82.  
  83.      GGGGLLLL____3333____BBBBYYYYTTTTEEEESSSS               _l_i_s_t_s is treated as an array of unsigned bytes.
  84.                               Each triplet of bytes specifies a single
  85.                               display-list name.  The value of the triplet is
  86.                               computed as 65536 times the unsigned value of
  87.                               the first byte, plus 256 times the unsigned
  88.                               value of the second byte, plus the unsigned
  89.                               value of the third byte.
  90.  
  91.      GGGGLLLL____4444____BBBBYYYYTTTTEEEESSSS               _l_i_s_t_s is treated as an array of unsigned bytes.
  92.                               Each quadruplet of bytes specifies a single
  93.                               display-list name.  The value of the quadruplet
  94.                               is computed as 16777216 times the unsigned value
  95.                               of the first byte, plus 65536 times the unsigned
  96.                               value of the second byte, plus 256 times the
  97.                               unsigned value of the third byte, plus the
  98.                               unsigned value of the fourth byte.
  99.  
  100.      The list of display-list names is not null-terminated.  Rather, _n
  101.      specifies how many names are to be taken from _l_i_s_t_s.
  102.  
  103.      An additional level of indirection is made available with the ggggllllLLLLiiiissssttttBBBBaaaasssseeee
  104.      command, which specifies an unsigned offset that is added to each
  105.      display-list name specified in _l_i_s_t_s before that display list is
  106.      executed.
  107.  
  108.      ggggllllCCCCaaaallllllllLLLLiiiissssttttssss can appear inside a display list.  To avoid the possibility
  109.      of infinite recursion resulting from display lists calling one another, a
  110.      limit is placed on the nesting level of display lists during display-list
  111.      execution.  This limit must be at least 64, and it depends on the
  112.      implementation.
  113.  
  114.      GL state is not saved and restored across a call to ggggllllCCCCaaaallllllllLLLLiiiissssttttssss.  Thus,
  115.      changes made to GL state during the execution of the display lists remain
  116.      after execution is completed.  Use ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb, ggggllllPPPPooooppppAAAAttttttttrrrriiiibbbb,
  117.      ggggllllPPPPuuuusssshhhhMMMMaaaattttrrrriiiixxxx, and ggggllllPPPPooooppppMMMMaaaattttrrrriiiixxxx to preserve GL state across ggggllllCCCCaaaallllllllLLLLiiiissssttttssss
  118.      calls.
  119.  
  120. NNNNOOOOTTTTEEEESSSS
  121.      Display lists can be executed between a call to ggggllllBBBBeeeeggggiiiinnnn and the
  122.      corresponding call to ggggllllEEEEnnnndddd, as long as the display list includes only
  123.      commands that are allowed in this interval.
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ggggllllCCCCaaaallllllllLLLLiiiissssttttssss((((3333GGGG))))                OOOOppppeeeennnnGGGGLLLL RRRReeeeffffeeeerrrreeeennnncccceeee                ggggllllCCCCaaaallllllllLLLLiiiissssttttssss((((3333GGGG))))
  137.  
  138.  
  139.  
  140. EEEERRRRRRRROOOORRRRSSSS
  141.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____VVVVAAAALLLLUUUUEEEE is generated if _n is negative.
  142.  
  143.      GGGGLLLL____IIIINNNNVVVVAAAALLLLIIIIDDDD____EEEENNNNUUUUMMMM is generated if _t_y_p_e is not one of GGGGLLLL____BBBBYYYYTTTTEEEE,
  144.      GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____BBBBYYYYTTTTEEEE, GGGGLLLL____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____SSSSHHHHOOOORRRRTTTT, GGGGLLLL____IIIINNNNTTTT, GGGGLLLL____UUUUNNNNSSSSIIIIGGGGNNNNEEEEDDDD____IIIINNNNTTTT,
  145.      GGGGLLLL____FFFFLLLLOOOOAAAATTTT, GGGGLLLL____2222____BBBBYYYYTTTTEEEESSSS, GGGGLLLL____3333____BBBBYYYYTTTTEEEESSSS, GGGGLLLL____4444____BBBBYYYYTTTTEEEESSSS.
  146.  
  147. AAAASSSSSSSSOOOOCCCCIIIIAAAATTTTEEEEDDDD GGGGEEEETTTTSSSS
  148.      ggggllllGGGGeeeetttt with argument GGGGLLLL____LLLLIIIISSSSTTTT____BBBBAAAASSSSEEEE
  149.      ggggllllGGGGeeeetttt with argument GGGGLLLL____MMMMAAAAXXXX____LLLLIIIISSSSTTTT____NNNNEEEESSSSTTTTIIIINNNNGGGG
  150.      ggggllllIIIIssssLLLLiiiisssstttt
  151.  
  152.  
  153. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  154.      ggggllllCCCCaaaallllllllLLLLiiiisssstttt, ggggllllDDDDeeeelllleeeetttteeeeLLLLiiiissssttttssss, ggggllllGGGGeeeennnnLLLLiiiissssttttssss, ggggllllLLLLiiiissssttttBBBBaaaasssseeee, ggggllllNNNNeeeewwwwLLLLiiiisssstttt,
  155.      ggggllllPPPPuuuusssshhhhAAAAttttttttrrrriiiibbbb, ggggllllPPPPuuuusssshhhhMMMMaaaattttrrrriiiixxxx
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.